home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / m / magic_workbench / magicworkbenchv2.0register.dms / in.adf / Docs / TM_Deutsch.doc < prev    next >
Encoding:
Text File  |  1993-01-22  |  48.9 KB  |  1,324 lines
  1.  
  2. ToolManager 2.0 Dokumentation
  3. ******************************
  4.  
  5.  
  6. Copyright und andere rechtliche Dinge
  7. **************************************
  8.  
  9.    Copyright (C) 1990-92 Stefan Becker
  10.  
  11.    Diese Dokumentation darf kopiert und weitergegeben werden solange die
  12. Copyright-Notiz und diese Erlaubnis unverändert auf allen Kopien
  13. enthalten ist.
  14.  
  15.    Es wird keine Garantie gegeben, daß die Programme, die in dieser
  16. Dokumentation beschrieben werden, 100%ig zuverlässig sind. Sie
  17. benutzen diese Programme auf eigene Gefahr. Der Autor kann auf *keinen*
  18. Fall für irgendwelche Schäden verantwortlich gemacht werden, die
  19. durch die Anwendung dieser Programme entstehen.
  20.  
  21.    Das Paket ist "freely distributable", aber das Copyright liegt
  22. weiterhin bei Stefan Becker. Dies bedeutet, daß es von jedem kopiert
  23. werden darf solange er nicht mehr als eine angemessene Kopiergebühr
  24. dafür verlangt. Diese Gebühr *darf nicht* höher sein als US $5 oder
  25. 5 DM.
  26.  
  27.    *Dieses Limit gilt auch für deutsche Public-Domain Händler!!*
  28.  
  29.    Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden,
  30. insbesondere in Fred Fishs Amiga Disk Library (CD ROM Versionen dieser
  31. Sammlung eingeschlossen). Die Distributionsdatei darf in
  32. Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses
  33. Paket weitergeben wollen, dann *müssen* Sie die originale
  34. Distributionsdatei `ToolManager2_0.lha' benutzen.
  35.  
  36.    Weder die Programme noch der Quelltext (oder Teile davon) dürfen
  37. ohne eine schriftliche Genehmigung des Autors in kommerziellen
  38. Programmen benutzt werden.
  39.  
  40.    Die Programme und der Quelltext (oder Teile davon) dürfen *auf
  41. keinen Fall* auf irgendeiner Maschine benutzt werden, die für die
  42. Forschung, Entwicklung, Konstruktion, Tests oder Produktion von Waffen
  43. oder anderen militärischen Gütern benutzt wird. Dies gilt natürlich
  44. auch für alle Maschinen, die für das Training von Personen in
  45. *irgendeiner* der obengenannten Tätigkeiten benutzt werden.
  46.  
  47.  
  48. Wichtige Bemerkungen
  49. *********************
  50.  
  51.    Willkommen zur wundervollen Welt von ToolManager 2.0 :-)
  52.  
  53.    - ToolManager und seine Konzepte wurden drastisch verändert (siehe
  54.      Geschichte) seit der letzten Version (1.5).
  55.  
  56.    - Beginnend mit der Version 2.0 ist ToolManager *GiftWare*. Wenn
  57.      Ihnen dieses Programm gefällt und Sie es sehr oft benutzen, dann
  58.      sollten Sie darüber nachdenken, ob sie dem Autor eine kleine
  59.      Spende schicken um die Arbeit zu honorieren, die er in dieses
  60.      Programm gesteckt hat. Ich schlage eine Spende in der
  61.      Größenordnung von US $10-$20 oder 10-20 DM vor. Bitte schicken Sie
  62.      mir außerhalb Europas keine Schecks, da es meistens mehr Geld
  63.      kostet, diesen Scheck einzulösen, als überhaupt Geld darauf ist.
  64.  
  65.      Wenn Sie keine Spende schicken oder es sich nicht erlauben
  66.      können, dann müssen sie sich nicht schuldig fühlen. Sie sollten
  67.      mir aber trotzdem einen Brief schicken, wenn sie ToolManager
  68.      benutzen (Ich liebe es Post zu bekommen :-). Siehe Adresse des
  69.      Autors.
  70.  
  71.    - Benutzer von ToolManager 1.X können mit dem Kapitel über die
  72.      Schnellinstallation beginnen (siehe Schnellinstallation). Einige
  73.      Merkmale haben sich nicht geändert und der Rest ist relativ
  74.      einfach durch Ausprobieren herauszufinden. Für eine genaue
  75.      Beschreibung des neuen Konzeptes und der neuen Merkmale schlagen
  76.      sie bitte in dem Referenzteil dieser Dokumentation nach (siehe
  77.      Objekte).
  78.  
  79.      Jede noch laufende ToolManager 1.X Version *muss* entfernt werden
  80.      oder die neue Version wird nicht funktionieren. Die neue Version
  81.      kann leider die Konfigurationsdatei der alten Version nicht lesen.
  82.  
  83.    - Erstbenutzer sollten die ganze Dokumentation lesen, um das Konzept
  84.      und den Zweck des Programmes zu verstehen. Beginnen sie mit
  85.      Einführung.
  86.  
  87.    - ToolManager 2.0 benutzt einige Merkmale der AmigaOS Version V38,
  88.      die (hoffentlich) für alle Benutzer zugänglich ist zu dem
  89.      Zeitpunkt, an dem sie dies hier lesen. Wenn sie noch die Version
  90.      2.0 benutzen (sie wird in dieser Dokumentation als V37
  91.      bezeichnet), dann brauchen sie keine Angst zu haben, denn
  92.      ToolManager arbeitet auch ohne diese neue Version. Alle
  93.      erweiterten V38 Merkmale sind in dieser Dokumentation markiert.
  94.  
  95.  
  96. Wohin man Bug reports, Kommentare & Spenden schickt
  97. ****************************************************
  98.  
  99.    Der Autor kann unter folgenden Adressen erreicht werden:
  100.  
  101. Postadresse:
  102.                Stefan Becker
  103.                Holsteinstrasse 9
  104.           5100 Aachen
  105.                GERMANY
  106.  
  107. InterNet Electronic Mail:
  108.  
  109.           stefanb@pool.informatik.rwth-aachen.de
  110.  
  111.  
  112. Wie man ToolManager 2.0 schnell installiert
  113. ********************************************
  114.  
  115.    Die grundlegende ToolManager 2.0 Installation besteht aus den
  116. folgenden vier Teilen:
  117.  
  118. `Libs/toolmanager.library' => `LIBS:'
  119.      Dies ist das Hauptprogramm von ToolManager. Es verwaltet alle
  120.      Programme, Menüs, Piktogramme und Docks (siehe Library).
  121.  
  122. `Prefs/ToolManager*' => `SYS:Prefs'
  123.      Dies ist der Voreinsteller für die Konfiguration (siehe
  124.      Voreinstellungen).
  125.  
  126. `WBStartup/ToolManager*' => `SYS:WBStartup'
  127.      Mit diesem Hilfsprogramm kann ToolManager gestartet und gestoppt
  128.      werden. Wenn es in der WBStartup Schublade liegt, dann wird
  129.      ToolManager immer automatisch beim Starten der Maschine geladen.
  130.  
  131. `L/WBStart-Handler' => `L:'
  132.      Dieses Programm startet Programme mit der Workbench-Startmethode.
  133.      Es ist ein eigener Prozess, so daß man ToolManager auch dann noch
  134.      verlassen kann, wenn man Workbenchprogramme gestartet hat.
  135.  
  136.  
  137. Was ist ToolManager?
  138. *********************
  139.  
  140.    ToolManager ist ein flexibles Programm zur Verwaltung von
  141. Hilfsprogrammen in Ihrer Arbeitsumgebung. Es kann sowohl Workbench-
  142. oder CLI-Programme starten als auch ARexx-Skripte ausführen. Die
  143. Benutzeroberfläche besteht aus Menüs, Piktogrammen und Dock-Fenstern.
  144. Wenn Sie einen lauten Computer mögen, dann können Sie zu jedem dieser
  145. Dinge einen Ton hinzufügen. Siehe Ton.
  146.  
  147.    ToolManger kann Einträge zu dem Workbench `Tools' Menü
  148. hinzufügen. Wenn Sie einen dieser Einträge auswählen, dann wird das
  149. dazugehörige Programm gestartet. Jedes Piktogramm, das zu diesem
  150. Zeitpunkt auf der Workbench ausgewählt ist, wird als Argument für
  151. dieses Programm benutzt. Menüeinträge sind nur dann möglich, wenn
  152. die Workbench läuft. Siehe Menü.
  153.  
  154.    ToolManager kann Piktogramme zum Workbench-Fenster hinzufügen.
  155. Falls Sie ein solches Piktogramm doppelklicken, dann wird das
  156. dazugehörige Programm gestartet. Wenn Sie einige Piktogramme auf dieses
  157. Piktogramm schieben, dann wird das Programm mit diesen Piktogrammen als
  158. Argumenten gestartet. Piktogramme sind nur dann möglich, wenn die
  159. Workbench läuft. Siehe Piktogramm.
  160.  
  161.    ToolManager kann ein Dock-Fenster aus einer Zusammenfassung von
  162. Programmen erstellen. Dieses Fenster kann auf jedem öffentlichen
  163. Schirm geöffnet werden. Jedes Programm wird durch ein Bild oder ein
  164. Textgadget repräsentiert. Um ein Programm zu starten brauchen Sie nur
  165. auf das Bild oder das Textgadget zu klicken. Falls das Fenster auf der
  166. Workbench geöffnet wurde und die Workbench läuft, dann können Sie
  167. auch einige Piktogramme auf das Bild oder das Textgadget schieben, um
  168. das Programm mit Argumenten zu starten. Siehe Dock.
  169.  
  170.    Weiterhin können Sie jedem Programm einen Tastenbefehl zuweisen.
  171. Wenn Sie diesen Tastenbefehl benutzen, dann wird das Programm
  172. gestartet. Beachten Sie dabei, daß in diesem Fall *keine* Argumente an
  173. das Programm übergeben werden können. Siehe Programm.
  174.  
  175.  
  176. Die Konzepte hinter ToolManager
  177. ********************************
  178.  
  179.    ToolManager 2.0 benutzt einen neuen objektorientierten Ansatz um ein
  180. flexibles und erweiterbares System zu ermöglichen. Dieser Ansatz
  181. machte viele Verbesserungen an den ToolManager 1.X Merkmalen möglich,
  182. z.B. man kann jetzt mehrere Dock-Fenster haben.
  183.  
  184.    Ein Objekt ist eine Zusammenfassung von Daten, die seine Merkmale
  185. beschreiben. Jedes Objekt hat einen Namen und einen Typ. Sie können
  186. von jedem Typ so viele Objekte erzeugen wie sie möchten, allerdings
  187. muß der Name jedes Objektes eindeutig sein, da er dazu benutzt wird um
  188. das Objekt anzusprechen.
  189.  
  190.    Momentan gibt es sechs verschiedene Objekttypen: Programm, Bild,
  191. Ton, Menü, Piktogramm und Dock. Die ersten drei Typen sind einfache
  192. Objekte, d.h. sie verweisen auf keine anderen Objekte. Sie stellen den
  193. komplexen Objekten Daten oder Dienste zur Verfügung.
  194.  
  195.    Die letzten drei Typen sind komplexe Objekte, d.h. sie verweisen auf
  196. einfache Objekte und benötigen deren Daten oder Dienste. Der Verweis
  197. geschieht aufgrund des Namens und falls kein einfaches Objekt mit
  198. diesem Namen existiert, dann ignoriert das komplexe Objekt es. Beachten
  199. Sie dabei, daß dies die Funktionalität des komplexen Objektes
  200. beeinträchtigen kann, z.B. benötigt ein Piktogrammobjekt die Daten
  201. eines Bildobjekts, anderenfalls wird es kein Piktogramm erzeugen.
  202.  
  203.    Für eine detailierte Beschreibung aller Objektparameter siehe
  204. Objekte.
  205.  
  206.  
  207. Beschreibungen für alle Dateien in der Distribution
  208. ****************************************************
  209.  
  210.    Die ToolManager 2.0 Distribution besteht aus mehreren
  211. Verzeichnissen, die alle weiter unten erläutert werden.
  212.  
  213.  
  214. Das Docs Verzeichnis
  215. =====================
  216.  
  217.    Dieses Verzeichnis enthält die Dokumentation für ToolManager. Die
  218. Dokumentation ist in vier verschiedenen Formaten und verschiedenen
  219. Sprachen vorhanden. Weiterhin existiert eine Datei in dem
  220. AutoDoc-Format, die die ToolManager shared library Schnittstelle
  221. beschreibt.
  222.  
  223. Prefix `TM_<Sprache>'
  224.      Diese Datei enthält die Dokumentation in der angegebenen Sprache.
  225.      Momentan sind folgende Sprachen vorhanden: Deutsch, English,
  226.      Svenska.
  227.  
  228. Postfix `.doc'
  229.      Diese Datei enthält die Dokumentation als einfacher ASCII-Text.
  230.  
  231. Postfix `.dvi'
  232.      Diese Datei enthält die Dokumentation in TeXs DVI-Format. Um
  233.      daraus eine gedruckte Dokumentation zu erstellen, müssen sie
  234.      diese Datei durch einen TeX Druckertreiber schicken.
  235.  
  236. Postfix `.guide'
  237.      Diese Datei enthält die Dokumentation im AmigaGuide-Format.
  238.      Obwohl dieses Format nur aus einfachem ASCII-Text mit ein paar
  239.      Befehlen besteht, benötigen Sie AmigaGuide um die Hypertext
  240.      Verkettungen nutzen zu können. Der Autor hofft, daß AmigaGuide
  241.      bald allen Amiga-Besitzern zur Verfügung steht.
  242.  
  243. Postfix `.tex'
  244.      Diese Datei enthält die Dokumentation im Texinfo-Format. Dieses
  245.      Format wurde von der Free Software Foundation (FSF) erfunden.
  246.      Zusammen mit dem `texinfo.tex' Makropaket können sie TeX und
  247.      `texindex' benutzen, um eine Datei im DVI-Format zu erstellen
  248.      (siehe oben).
  249.  
  250. `toolmanager.doc'
  251.      Diese Datei beschreibt die ToolManager shared library
  252.      Schnittstelle im AutoDoc-Format.
  253.  
  254.  
  255. Das Goodies Verzeichnis
  256. ========================
  257.  
  258.    Dieses Verzeichnis enthält zusätzliche Programmpakete, die
  259. nützlich für ToolManager sind.
  260.  
  261. `GetPubName.lha'
  262.      Dieses kleine Programm gibt den Namen des obersten öffentlichen
  263.      Schirms auf die Standardausgabe oder in eine Umgebungsvariable
  264.      aus. Es wurde geschrieben von Michael "Mick" Hohmann.
  265.  
  266. `upd1_20.lha'
  267.      Das Programm `upd' wurde geschrieben von Jonas Petersson. Es ist
  268.      ein kleines Program, daß einen ARexx-Port öffnet und auf Befehle
  269.      wartet. Mit Hilfe von ARexx können Sie `upd' veranlassen
  270.      digitalisierte Töne und Geräusche abzuspielen. ToolManager
  271.      benutzt diese Eigenschaft um seine Tonobjekte zu realisieren. Siehe
  272.      Ton.
  273.  
  274.    ToolManager 1.5 Benutzer mögen sich wundern, wo das Hilfsprogramm
  275. `DeleteTool' geblieben ist. Es kann durch das Program `BlackHole' von
  276. der Fish Disk #622 ersetzt werden.
  277.  
  278.  
  279. Das Graphics Verzeichnis
  280. =========================
  281.  
  282.    Dieses Verzeichnis enthält eine reichhaltige Sammlung von Bildern
  283. aus denen Sie wählen können. Laden Sie sie einfach als Bildobjekte in
  284. ToolManager (siehe Bild).
  285.  
  286.    Die Dateien wurden von verschiedenen Personen zur Verfügung gestellt
  287. (siehe Danksagungen). Jeder von ihnen hat ein eigenes Unterverzeichnis
  288. erhalten. Da diese Dateien von verschieden Personen erstellt wurden,
  289. stammen sie aus verschiedenen Umgebungen (Farbpalette, Tiefe,
  290. Auflösung, Größe) und haben unterschiedliche Desginstile. Es kann
  291. also durchaus vorkommen, daß sie nicht gut auf Ihrer Maschine aussehen.
  292.  
  293.    Damit man die unterschiedlichen Formate, die von ToolManager
  294. unterstützt werden, unterscheiden kann, hat jeder Dateiname einen
  295. speziellen Postfix:
  296.  
  297. `.anmb'
  298.      Dies ist eine IFF ANIM Datei, die von einem Mal- oder
  299.      Animationsprogramm erstellt wurde. Sie kann mehrere Bilder
  300.      enthalten. Obwohl ToolManager komplette ANIM Dateien laden kann,
  301.      sollten sie eine ähnliche Funktion wie DPaints "AnimBrush"
  302.      benutzen, um den interessanten Teil aus der Animation
  303.      herauszuschneiden.
  304.  
  305. `.brush'
  306.      Dies ist eine IFF ILBM Datei, die von einem Malprogramm erzeugt
  307.      wurde. Sie enthält nur ein Bild.
  308.  
  309. `.info'
  310.      Dies ist eine normale Amiga Piktogrammdatei, die durch IconEdit
  311.      (oder etwas ähnliches) erzeugt wurde. Sie kann zwei Bilder
  312.      enthalten.
  313.  
  314.  
  315. Das L Verzeichnis
  316. ==================
  317.  
  318.    Dieses Verzeichnis enthält nur eine Datei, nämlich
  319. `WBStart-Handler'. Sie *müssen* diese Datei in das `L:' Verzeichnis
  320. kopieren, sonst kann ToolManager keine Programmobjekte mit der
  321. Workbench-Startmethode starten (siehe Programm).
  322.  
  323.    Das komplette WBStart 1.2 Paket wird auf einer Fish Disk erscheinen.
  324.  
  325.  
  326. Das Libs Verzeichnis
  327. =====================
  328.  
  329.    Dieses Verzeichnis enthält nur eine Datei, `toolmanager.library'.
  330. Dies ist das Hauptprogramm von ToolManager und muß in das `LIBS:'
  331. Verzeichnis kopiert werden.
  332.  
  333.  
  334. Das Locale Verzeichnis
  335. =======================
  336.  
  337.    Dieses Verzeichnis enthält alle Dateien für die Lokalisation von
  338. ToolManager. Da die locale.library erst in V38 enthalten ist, brauchen
  339. Sie keine dieser Dateien zu kopieren, falls sie noch V37 benutzen. Wenn
  340. Sie schon V38 benutzen, dann wählen Sie die Ihrer Sprache
  341. entsprechende Datei.
  342.  
  343. `Catalogs/<Sprache>/toolmanager.catalog'
  344.      Dies ist eine Übersetzungsdatei für die angegebene Sprache.
  345.      Kopieren Sie die Datei für Ihre Sprache in das Verzeichnis
  346.      `LOCALE:Catalogs/<Sprache>'.
  347.  
  348. `Languages/<Sprache>.language'
  349.      Einige Sprachen werden noch nicht unterstützt von der Standard
  350.      V38 Locale Distribution. Daher haben einige Übersetzer eine
  351.      `.language' Datei mitgeliefert, damit ToolManager ihre
  352.      Übersetzungsdateien benutzen kann. Kopieren Sie die Datei für
  353.      Ihre Sprache in das Verzeichnis `LOCALE:Languages'. Es sind
  354.      folgende zusätzlichen Sprachen verfügbar: Finnish (suomi),
  355.      Eefeler Platt (eifel).
  356.  
  357.  
  358. Das Prefs Verzeichnis
  359. ======================
  360.  
  361.    Der ToolManager Voreinsteller und sein Icon befinden sich in diesem
  362. Verzeichnis. Kopieren Sie beide Dateien in das Verzeichnis `SYS:Prefs'.
  363. Für weitere Informationen siehe Voreinstellungen.
  364.  
  365.  
  366. Das Programmers Verzeichnis
  367. ============================
  368.  
  369.    Dieses Verzeichnis enthält alle Dateien, die von den verschiedenen
  370. Programmiersprachen und deren Compilern benötigt werden, um die
  371. ToolManager shared library Schnittstelle zu benutzen. Das
  372. Unterverzeichnis `examples' enthält mehrere Beispiele dazu. Für eine
  373. komplette Beschreibung der Schnittstelle lesen Sie bitte die Datei
  374. `Docs/toolmanager.doc'.
  375.  
  376.    Momentan werden die folgenden Sprachen bzw. Compiler unterstützt:
  377. AmigaOberon, DICE C, M2Amiga Modula, MANX Aztec C and SAS C.
  378.  
  379.  
  380. Das Scripts Verzeichnis
  381. ========================
  382.  
  383.    Dieses Verzeichnis enthält eine Sammlung von ARexx- und
  384. Shell-Skripten, die in ToolManager Programmobjekten benutzt werden
  385. können. Beachen Sie, daß diese Skriptdateien an Ihre persönliche
  386. Arbeitsumgebung oder Shell angepasst werden müssen.
  387.  
  388.  
  389. Das Source Verzeichnis
  390. =======================
  391.  
  392.    Dieses Verzeichnis enthält den kompletten Quelltext zu ToolManager
  393. 2.0 und seinen Hilfsprogrammen. Jedes Programm hat sein eigenes
  394. Unterverzeichnis. Der Autor stellt den Quelltext als Beispiel für die
  395. Programmierung unter OS 2.0 zur Verfügung.
  396.  
  397.    Das Unterverzeichnis `locale' ist für Übersetzer interessant.
  398. Falls Ihre Sprache in dieser Version nicht unterstützt wird und Sie
  399. eine Übersetzung machen möchten, dann sollten Sie sich die Datei
  400. `empty.ct' anschauen. Sie müssen nur die Leerzeilen füllen und die
  401. Datei zu mir senden. Die Übersetzung wird dann eventuell in der
  402. nächsten Version enthalten sein.
  403.  
  404.  
  405. Das WBStartup Verzeichnis
  406. ==========================
  407.  
  408.    Dieses Verzeichnis enthält nur ein Programm: `ToolManager'. Dieses
  409. Hilfsprogramm startet und stoppt ToolManager 2.0. Meistens wird dieses
  410. Programm in das Verzeichnis `SYS:WBStartup' kopiert, aber man kann es
  411. auch von der Shell aus benutzen.
  412.  
  413.  
  414. Beschreibung der ToolManager-Objekte
  415. *************************************
  416.  
  417.    Dieses Kapitel beschreibt die ToolManager-Objekte im einzelnen.
  418. Jedes Objekt hat einen Typ und einen Namen. Der Name wird benutzt, um
  419. das Objekt anzusprechen. Es gibt sechs verschiedene Typen von Objekten:
  420.  
  421.  
  422. Programmobjekte
  423. ================
  424.  
  425.    Programmobjekte beschreiben Programme, die von ToolManager gestartet
  426. werden sollen. Es werden drei verschiedene Typen von Programmen
  427. unterstützt: CLI, Workbench und ARexx. Jedes Programmobjekt hat die
  428. folgenden Parameter. Die Vorgabewerte sind in Klammern gesetzt:
  429.  
  430. `Aktuelles Verzeichnis' (`SYS:')
  431.      Der Name des aktuellen Verzeichnisses für das Programm.
  432.      ARexx-Programme ignorieren diesen Parameter.
  433.  
  434. `Argumente' (Ja)
  435.      Dieser Schalter kontrolliert die Argumentübergabe an das
  436.      Programm. Falls ein Programm keine Argumente annimmt oder sie
  437.      nicht benötigt, dann können Sie hiermit die Argumentübergabe
  438.      abschalten.
  439.  
  440. `Ausgabedatei' (`NIL:')
  441.      Der Dateiname für die Ausgabedatei. Dieser Parameter ist nur
  442.      sinnvoll für CLI Programme.
  443.  
  444. `Befehl'
  445.      Der Dateiname für das zu startende Programm. Der Name kann
  446.      relativ zum aktuellen Verzeichnis sein.
  447.  
  448. `Befehlspfad' (Pfad des ToolManager-Prozesses)
  449.      Dieser Parameter setzt den Befehlspfad für das Programm. Es
  450.      können mehrere Verzeichnisse angegeben werden in dem man sie mit
  451.      ";" trennt. Dieser Parameter ist nur sinnvoll für CLI Programme.
  452.  
  453. `Nach vorne' (Nein)
  454.      Wenn dieser Parameter gesetzt ist, dann wird der mit `Öffentlicher
  455.      Schirm' angegebene öffentliche Schirm nach vorne geholt, bevor
  456.      das Programm gestartet wird.
  457.  
  458. `Öffentlicher Schirm' (Default)
  459.      Sie können mit diesem Parameter angeben, welcher öffentlicher
  460.      Schirm nach vorne geholt werden soll, bevor das Programm gestartet
  461.      wird. Dieser Parameter funktioniert nur im Zusammenhang mit `Nach
  462.      vorne'.
  463.  
  464. `Priorität' (0)
  465.      Dieser Parameter setzt die Priorität des neuen Prozesses, in dem
  466.      das Programm läuft.
  467.  
  468. `Programmtyp' (CLI)
  469.      Dies gibt den Typ des Programmes an. Es kann einer der drei
  470.      folgenden Typen angegeben werden: CLI, WB oder ARexx.
  471.  
  472. `Stack' (4096)
  473.      Dieser Parameter setzt die Stackgröße des neuen Prozesses, in
  474.      dem das Programm läuft.
  475.  
  476. `Tastenbefehl'
  477.      Sie können für jedes Programmobjekt einen Tastenbefehl angeben.
  478.      Wenn Sie diesen Tastenbefehl benutzen wird das Programm gestartet.
  479.      Beachten Sie: Das Programm wird ohne Argumente gestartet.
  480.  
  481. `Verzögerung' (0)
  482.      Nach der Aktivierung eines Programmobjekts wartet ToolManager
  483.      `Verzögerung' Sekunden bevor er das Programm startet. Wenn dieser
  484.      Wert negativ ist, dann wird das Programm alle `Verzögerung'
  485.      Sekunden gestartet. Falls Sie ein Programmobjekt stoppen wollen,
  486.      das auf die Ausführung wartet, aktivieren Sie es einfach noch
  487.      einmal. Beachten Sie: Wenn `Verzögerung' gesetzt ist, dann wird
  488.      das Programm ohne Argumente gestartet.
  489.  
  490.  
  491. Bildobjekte
  492. ============
  493.  
  494.    Bildobjekte geben die Bilddaten an, die von ToolManager für
  495. Piktogramme und Dock-Fenster benutzt werden. Dieser Objekttyp hat nur
  496. einen Parameter:
  497.  
  498. `Dateiname'
  499.      Dieser Parameter gibt den Namen der Datei an, aus der ToolManager
  500.      die Bilddaten lesen soll. ToolManager versucht den Typ der
  501.      Bilddaten automatisch zu erkennen:
  502.  
  503.        1. Er versucht die Daten als IFF Daten zu laden. Momentan kann
  504.           ToolManager ILBM (ein Bild) oder ANIM (zwei oder mehr Bilder)
  505.           Dateien lesen.
  506.  
  507.        2. Er versucht die Datei als Piktogrammdatei zu lesen. Ein
  508.           Piktogramm kann ein oder zwei Bilder enthalten.
  509.  
  510.    Animation werden momentan nur von Dock-Objekten unterstützt.
  511. Piktogrammobjekte entnehmen momentan nur das erste und das zweite Bild
  512. einer Animation um ein Piktogramm aus 2 Bildern zu erstellen. Wenn Sie
  513. eine Animation für ToolManager erstellen wollen, dann sollten Sie sich
  514. an folgende Regeln halten:
  515.  
  516. Bild 1
  517.      Dieses Bild sollte den inaktiven Zustand repräsentieren.
  518.  
  519. Bild 2
  520.      Dieses Bild sollte den selektierten Zustand repräsentieren.
  521.      Normalerweise ist es eine invertierte Kopie des ersten Bildes.
  522.  
  523. Bild 3 bis N-1
  524.      Dies sind die Bilder der eigentlichen Animation. Jedes Bild wird
  525.      für eine 1/3 Sekunde angezeigt.
  526.  
  527. Bild N
  528.      Das letzte Bild der Animation wird für eine Sekunde angezeigt.
  529.      Danach wird wieder das erste Bild angezeigt.
  530.  
  531.  
  532. Tonobjekte
  533. ===========
  534.  
  535.    Ein Tonobjekt wird benutzt, wenn ToolManager laut werden soll.
  536. ToolManager hat selber keinen eingebauten Spieler für digitalisierte
  537. Geräusche. Er benutzt ARexx, um einen externen Geräuscheabspieler
  538. anzusteuern. Dieser Objekttyp hat zwei Parameter:
  539.  
  540. `Befehl'
  541.      Dieser Parameter gibt den ARexx-Befehl an, den ToolManager an den
  542.      externen Geräuscheabspieler senden soll. Für `upd' könnte dies
  543.      etwas ähnliches wie `file samples:boing' sein, was `upd' anweist
  544.      die IFF Datei `samples:boing' abzuspielen. Siehe Goodies.
  545.  
  546. `ARexx-Port'
  547.      Dieser Parameter gibt den Namen des ARexx-Ports an, an den
  548.      ToolManager `Befehl' senden soll. Der voreingestellte Name ist
  549.      `PLAY', der Name für das Programm `upd'.
  550.  
  551.  
  552. Menüobjekte
  553. ============
  554.  
  555.    Menüobjekte erzeugen Menüeinträge im Workbench Tools Menü. Der
  556. Objektname wird benutzt als Menütext. Um ein solches Objekt zu
  557. aktivieren müssen Sie einfach den entsprechenden Menüeintrag
  558. selektieren. Menüobjekte sind nur verfügbar wenn die Workbench läuft.
  559.  
  560.    Dieser Objekttyp hat zwei Parameter:
  561.  
  562. `Programmobjekt'
  563.      Dies ist der Name eines Programmobjektes, das aktiviert werden
  564.      soll, wenn der Menüeintrag selektiert wurde. Jedes Piktogramm,
  565.      das zu diesem Zeitpunkt ausgewählt ist, wird als Argument für
  566.      das Programm benutzt.
  567.  
  568. `Tonobjekt'
  569.      Dies ist der Name eines Tonobjekts, das aktiviert werden soll,
  570.      wenn der Menüeintrag selektiert wurde.
  571.  
  572.    ToolManager 1.X Benutzer: Wenn Sie den alten Tooltyp "Dummy"
  573. simulieren wollen, dann erzeugen Sie einfach eine Menüobjekt und geben
  574. *kein* Programm- oder Tonobjekt an.
  575.  
  576.  
  577. Piktogrammobjekte
  578. ==================
  579.  
  580.    Piktogrammobjekte beschreiben Applikationspiktogramme im
  581. Workbench-Fenster. Solch ein Objekt kann aktiviert werden durch
  582. Doppelklicken des Piktogramms oder indem einige Piktogramme auf das
  583. Applikationspiktogramm geschoben werden. Piktogrammobjekte sind nur
  584. verfügbar wenn die Workbench läuft.
  585.  
  586.    Die Parameter für diesen Objekttyp sind wie folgt:
  587.  
  588. `Bildobjekt'
  589.      Dies ist der Name eines Bildobjekts. Die Bilddaten dieses Objektes
  590.      werden dazu benutzt das Applikationspiktogramm zu erstellen.
  591.  
  592. `Linke Kante' (Vorgabe: 0)
  593.      Dies setzt die linke Kante für das Applikationspiktogramm.
  594.  
  595. `Obere Kante' (Vorgabe: 0)
  596.      Dies setzt die obere Kante für das Applikationspiktogramm.
  597.  
  598. `Programmobjekt'
  599.      Dies ist der Name eines Programmobjektes, das aktiviert werden
  600.      soll wenn das Piktogramm selektiert wurde. Jedes Piktogramm, das
  601.      auf das Applikationspiktogramm geschoben wurde, wird als Argument
  602.      für das Programm benutzt.
  603.  
  604. `Tonobjekt'
  605.      Dies ist der Name eines Tonobjekts, das aktiviert werden soll wenn
  606.      das Piktogramm selektiertiert wurde.
  607.  
  608. `Zeige Namen' (Vorgabe: Ja)
  609.      Wenn dieser Parameter gesetzt ist, dann wird der Objektname als
  610.      Namen für das Applikationspiktogramm benutzt.
  611.  
  612.    Die Workbench ist *sehr* eigensinnig mit Piktogrammpositionen. Wenn
  613. Sie eine Position gewählt haben, die der Workbench nicht zusagen, dann
  614. ignoriert sie sie einfach und legt das Piktogramm irgendwo anders hin.
  615.  
  616.  
  617. Dock-Objekte
  618. =============
  619.  
  620.    Dock-Objekte beschreiben Fenster. Diese Fenster fassen mehrere
  621. Programme zusammen, welche durch Bilder oder Textgadgets repräsentiert
  622. werden. Um ein Programm zu starten, braucht man nur auf das Bild oder
  623. das Textgadget zu klicken. Natürlich können auch Piktogramme auf das
  624. Bild oder das Textgadget geschoben werden, um das Programm mit
  625. Argumenten zu versorgen.
  626.  
  627.    Jedes Dock-Objekt hat die folgenden Parameter. Die Vorgaben sind in
  628. Klammern gesetzt:
  629.  
  630. `Aktiviert' (Ja)
  631.      Ein Dock-Fenster kann aktiv (offen) oder nicht aktiv (geschlossen)
  632.      sein.
  633.  
  634. `Fensternamen'
  635.      Dieser Parameter setzt den Namen des Dock-Fensters. Wenn Sie einen
  636.      Fensternamen angeben, dann öffnet sich eine normales OS 2.0
  637.      Fenster mit Dragbar, Close-Gadget, Depth-Gadget und einem Rand.
  638.      Wenn Sie *keinen* Namen angeben, dann öffnet sich ein Fenster,
  639.      das keinen Rahmen und nur einen Dragbar hat.
  640.  
  641. `Linke Kante' (0)
  642.      Linke Kante des Dock-Fensters. Dieser Parameter wird ignoriert,
  643.      wenn der Parameter `Zentriert' gesetzt ist.
  644.  
  645. `Menü' (No)
  646.      An jedes Dock-Fenster kann ein Menü angehängt werden. Dieses
  647.      Menü hat zwei Einträge:
  648.  
  649.         * `Dock schliessen' Schliessen des Dock-Fensters.
  650.  
  651.         * `TM beenden' ToolManager beenden.
  652.  
  653. `Muster' (Nein)
  654.      Das Dock-Fenster richtet sich automatisch nach der Grösse des
  655.      größten Bildes. Da jeder Eintrag die gleiche Grösse hat und
  656.      kleinere Bilder zentriert werden, haben kleinere Bilder einen
  657.      leeren Rand. Falls Sie diesen Rand nicht mögen, dann können Sie
  658.      mit diesem Parameter ein Muster einschalten.
  659.  
  660. `Obere Kante' (0)
  661.      Obere Kante des Dock-Fensters. Dieser Parameter wird ignoriert,
  662.      wenn der Parameter `Zentriert' gesetzt ist.
  663.  
  664. `Öffentlicher Schirm' (Default)
  665.      Dies gibt den öffentlichen Schirm an, auf dem das Dock-Fenster
  666.      geöffnet werden soll. Wenn das Fenster mit Hilfe des
  667.      Tastenbefehls geöffnet wurde, dann wird der öffentliche Schirm
  668.      nach vorne geholt. Dieser Parameter wird ignoriert, wenn der
  669.      Parameter `Vorderster' gesetzt ist.
  670.  
  671. `PopUp' (No)
  672.      Wenn dieser Parameter gesetzt ist, dann schliesst sich das
  673.      Dock-Fenster automatisch, nachdem ein Eintrag ausgewählt wurde.
  674.      Dieser Parameter ist besonders nützlich in Verbindung mit den
  675.      Parametern `Vorderster', `Zentriert' und einem Tastenbefehl der
  676.      Klasse `rawmouse' (siehe Tastenbefehle).
  677.  
  678. `Spalte' (1)
  679.      Dieser Parameter setzt die Anzahl der Spalten in dem Dock-Fenster.
  680.      Die Einträge werden zeilenweise einsortiert, beginnend mit der
  681.      linken Spalte und fortlaufend bis zur rechten Spalte.
  682.  
  683. `Tastenbefehl'
  684.      Sie können für jedes Dock-Objekt einen Tastenbefehl angeben.
  685.      Wenn Sie diesen Tastenbefehl benutzen, dann wird der Status des
  686.      Dock-Fensters umgeschaltet, d.h. es wird geöffnet oder
  687.      geschlossen.
  688.  
  689. `Text' (Nein)
  690.      Mit diesem Parameter können Sie zwischen Bildern und Textgadgets
  691.      in Dock-Fenstern wählen. Dock-Fenster mit Textgadgets sind
  692.      besonders nützlich in Verbindung mit dem Parameter `PopUp'.
  693.  
  694. `Vertikal' (No)
  695.      Dieser Parameter setzt die Richtung der Dragbar. Dieser Parameter
  696.      wird ignoriert, wenn Sie einen Fensternamen mit dem Parameter
  697.      `Fensternamen' angegeben haben.
  698.  
  699. `Vorderster' (Nein)
  700.      Wenn dieser Parameter gesetzt ist, dann öffnet sich das
  701.      Dock-Fenster immer auf dem vordersten öffentlichen Schirm.
  702.  
  703. `Zeichensatz' (Zeichensatz des Schirms)
  704.      Wenn in einem Dock-Objekt der Parameter `Text' gesetzt ist, dann
  705.      kann mit diesem Parameter der Zeichensatz für die Textgadgets
  706.      gewählt werden.
  707.  
  708. `Zentriert' (Nein)
  709.      Wenn dieser Parameter gesetzt ist, dann wird das Dock-Fenster
  710.      immer zentriert zur aktuellen Mausposition geöffnet.
  711.  
  712.  
  713. Der Voreinsteller für ToolManager
  714. **********************************
  715.  
  716.    Mit dem Voreinsteller können Sie die globale Konfiguration von 
  717. ToolManager manipulieren. Diese Konfiguration wird automatisch beim
  718. Start von ToolManager geladen. Um den Voreinsteller zu starten, müssen
  719. Sie sein Piktogramm doppelklicken. Danach öffnet sich das Hauptfenster.
  720.  
  721.  
  722. Gadgets im Hauptfenster
  723. ========================
  724.  
  725.    Das Hauptfenster hat mehrere Gruppen von Gadgets:
  726.  
  727. Objekttyp
  728.      Mit diesem zyklischem Auswahlgadget kann der Typ der Objekte
  729.      gewählt werden, die Sie erzeugen oder ändern wollen.
  730.  
  731. Objektliste
  732.      Dieses Gadget zeigt die Liste aller Objekte des aktuellen Typs an.
  733.      Sie können ein Objekt auswählen indem sie auf seinen Namen
  734.      klicken. Wenn sie einen Eintrag doppelklicken, dann öffnet sich
  735.      das Objektfenster.
  736.  
  737. Objekt verschieben
  738.      Wenn ein Objekt ausgewählt worden ist, dann kann es mit diesen
  739.      Gadgets in der Liste verschoben werden. Das `Sortieren' Gadget
  740.      dient dazu, die Liste alphabetisch zu sortieren.
  741.  
  742. Objekt manipulieren
  743.      Diese Gadgets manipulieren Objekte. Das `Neu' Gadget erzeugt ein
  744.      neues Gadget vom aktuellen Typ. Dieses neue Objekt wird
  745.      automatisch selektiert. Das `Ändern' Gadget öffnet das
  746.      Objektfenster. Mit dem `Kopieren' Gadget kann man eine Kopie des
  747.      selektierten Objektes erstellen. Das `Entfernen' Gadget löscht
  748.      das selektierte Objekt.
  749.  
  750. Konfiguration
  751.      Sie haben mehrere Möglichkeiten die Konfiguration zu speichern.
  752.      Mit dem `Speichern' Gadget wird die Konfiguration permanent in der
  753.      Datei `ENVARC:ToolManager.prefs' gespeichert. Für eine temporäre
  754.      Änderung kann die Konfiguration mit dem `Benutzen' Gadget in der
  755.      Datei `ENV:ToolManager.prefs' abgespeichert werden. Diese Datei
  756.      wird bei einem Reset gelöscht. Wenn Sie eine Konfiguration testen
  757.      wollen, ohne den Voreinsteller zu verlassen, dann benutzen Sie das
  758.      `Testen' Gadget. Mit dem `Abbrechen' Gadget können Sie den
  759.      Voreinsteller ohne Abspeichern verlassen.
  760.  
  761.  
  762. Menüs des Hauptfensters
  763. ========================
  764.  
  765.    Das Hauptfenster hat mehrere Menüs:
  766.  
  767. `Project'
  768.      Mit den Menüeinträgen `öffnen' und `speichern als' können Sie
  769.      die Konfiguration laden und speichern. Der `Information' Eintrag
  770.      öffnet einen Informationsrequester. Mit dem Eintrag `beenden' kann
  771.      man den Voreinsteller ohne Abspeichern verlassen.
  772.  
  773. `Vorgaben'
  774.      Mit diesen Menüeinträgen können ältere Konfigurationen
  775.      wiederhergestellt werden. Der Eintrag `auf zuletzt gespeichertes'
  776.      lädt die Konfiguration aus der Datei `ENVARC:ToolManager.prefs'.
  777.      Mit dem Eintrag `auf vorherigen Stand' wird diejenige
  778.      Konfiguration, die vor dem Start des Voreinstellers gültig war,
  779.      aus der Datei `ENV:ToolManager.prefs' geladen.
  780.  
  781. `Optionen'
  782.      Mit dem Eintrag `Piktogramme erzeugen?' können Sie vorgeben, ob
  783.      der Eintrag `speichern als' ein Piktogramm erzeugen soll oder
  784.      nicht.
  785.  
  786.  
  787. Objektfenster
  788. ==============
  789.  
  790.    Jeder Objekttyp hat ein eigenes Objektfenster, in dem man die
  791. Objektparameter setzen kann. Für eine detailierte Liste aller
  792. Parameter siehe Objekte.
  793.  
  794.    Jedes Objektfenster hat ein Gadget für den Objektnamen. Dieser Name
  795. ist wichtig, da er dazu benutzt wird das Objekt anzusprechen. Beachten
  796. Sie, daß es keine Querverweise gibt, d.h. wenn Sie den Namen eines
  797. Objektes ändern, das schon von einem anderen Objekt verwendet wird, so
  798. wird der Verweis in diesem Objekt *nicht* aktualisiert. Sie müssen
  799. diesen Verweis per Hand aktualisieren.
  800.  
  801.    Die Tastengadgets in den Objektfenstern öffnen verschiedene
  802. Requester. Sie können einen Eintrag auswählen, indem sie den Namen
  803. und das `Benutzen' Gadget anklicken oder indem sie den Namen
  804. doppelklicken. Um einen Requester ohne Änderungen zu verlassen,
  805. benutzen Sie das `Abbrechen' Gadget. Wenn sie ein Feld löschen wollen,
  806. das nur mit einem Requester ausgewählt werden kann, dann öffnen Sie
  807. den Requester und klicken das `Benutzen' Gadget *ohne* vorher einen
  808. Eintrag auszuwählen.
  809.  
  810.    Die Objekfenster für Programm- und Bildobjekte haben ein
  811. zusätzliches Merkmal. Sie können ein Piktogramm auf diese Fenster
  812. schieben und die Parameter werden aus diesem Piktogramm entnommen.
  813.  
  814.  
  815. Tooltypes
  816. ==========
  817.  
  818.    Wenn Sie den Voreinsteller von der Workbench starten, dann können
  819. Sie in den Piktogrammen für das Programm oder den
  820. Konfigurationsdateien verschiedene Tooltypes setzen, um den
  821. Voreinsteller zu kontrollieren.
  822.  
  823. `USE'
  824.      Wenn Sie diesen Tooltype in einem Piktogramm für eine
  825.      Konfigurationsdatei setzen, dann installiert der Voreinsteller
  826.      diese Datei als aktuelle Konfiguration.
  827.  
  828. `SAVE'
  829.      Wenn Sie diesen Tooltype in einem Piktogramm für eine
  830.      Konfigurationsdatei setzen, dann installiert der Voreinsteller
  831.      diese Datei als aktuelle und permanente Konfiguration.
  832.  
  833. `PUBSCREEN'
  834.      Dieser Tooltype gibt den Namen des öffentlichen Schirms an, auf
  835.      dem der Voreinsteller seine Fenster öffnen soll.
  836.  
  837. `CREATEICONS'
  838.      Wenn dieser Tooltype auf `YES' gesetzt wird, dann erzeugt der
  839.      Voreinsteller für jede Konfigurationsdatei, die mit dem
  840.      Menüeintrag `speichern als' erzeugt wird, ein Piktogramm.
  841.  
  842. `DEFAULTFONT'
  843.      Normalerweise benutzt der Voreinsteller den Zeichensatz des
  844.      öffentlichen Schirms um seine Gadgets zu erzeugen. Wenn Sie diesen
  845.      Tooltype auf `YES' setzen, dann benutzt der Voreinsteller den
  846.      Standard Systemzeichensatz.
  847.  
  848.  
  849. CLI Argumente
  850. ==============
  851.  
  852.    Wenn der Voreinsteller von der Shell gestartet wird, dann benutzt er
  853. folgende Schablone für die Kommandozeile:
  854.  
  855.      FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,DEFAULTFONT/S
  856.  
  857. `FROM'
  858.      Dieser Parameter gibt an, welche Konfigurationsdatei der
  859.      Voreinsteller laden soll.
  860.  
  861. `USE'
  862.      Wenn Sie diesen Parameter benutzen, dann installiert der
  863.      Voreinsteller die Datei, die mit dem `FROM' Parameter angegeben
  864.      wurde, als aktuelle Konfiguration.
  865.  
  866. `SAVE'
  867.      Wenn Sie diesen Parameter benutzen, dann installiert der
  868.      Voreinsteller die Datei, die mit dem `FROM' Parameter angegeben
  869.      wurde, als aktuelle und permante Konfiguration.
  870.  
  871. `PUBSCREEN'
  872.      Dieser Parameter gibt den Namen des öffentlichen Schirms an, auf
  873.      dem der Voreinsteller seine Fenster öffnen soll.
  874.  
  875. `DEFAULTFONT'
  876.      Normalerweise benutzt der Voreinsteller den Zeichensatz des
  877.      öffentlichen Schirms um seine Gadgets zu erzeugen. Wenn Sie diesen
  878.      Parameter angeben, dann benutzt der Voreinsteller den Standard
  879.      Systemzeichensatz.
  880.  
  881.  
  882. Die ToolManager shared library Schnittstelle
  883. *********************************************
  884.  
  885.    Der ToolManager-Handler ist in eine Amiga shared library
  886. eingebettet. Diese Library bietet mehrere Funktionen an, um
  887. ToolManager-Objekte zu erzeugen und zu manipulieren, so daß Sie sie
  888. von Ihren Programmen aus benutzen können.
  889.  
  890.    Momentan sind 6 Funktionen vorhanden:
  891.  
  892. `AllocTMHandle()'
  893.      Damit Sie ToolManager-Objekte erzeugen können, müssen Sie zuerst
  894.      einen TMHandle allozieren. Diese Datenstruktur speichert alle
  895.      Informationen über Ihre Objekte und sie wird dazu benutzt Ihre
  896.      Objekte anzusprechen. Beachten Sie, daß die Information, die in
  897.      dieser Datenstruktur gespeichert ist, *nur* dem Programm
  898.      zugänglich ist, das den TMHandle erzeugt hat.
  899.  
  900. `FreeTMHandle()'
  901.      Diese Funktion gibt einen TMHandle und alle mit ihm verbundenen
  902.      ToolManager-Objekte frei. Jeder `AllocTMHandle()' Aufruf muß mit
  903.      einem `FreeTMHandle()' Aufruf gepaart sein!
  904.  
  905. `CreateTMObjectTags()'
  906. `CreateTMObjectTagList()'
  907.      Diese Funktion erzeugt ein ToolManager-Objekt. Sie müssen einen
  908.      Namen, den Objekttyp und verschiedene Tags für die
  909.      Objektparameter angeben. Der Name des Objekts ist wichtig, da er
  910.      dazu benutzt wird, das Objekt anzusprechen.
  911.  
  912. `ChangeTMObjectTags()'
  913. `ChangeTMObjectTagList()'
  914.      Sie können die Parameter eines ToolManager-Objekts mit dieser
  915.      Funktion verändern. Beachten Sie, daß Bildobjekte momentan nicht
  916.      geändert werden können.
  917.  
  918. `DeleteTMObject()'
  919.      Diese Funktion löscht ein ToolManager-Objekt. Falls andere
  920.      Objekte auf dieses Objekt verweisen, dann werden diese
  921.      benachrichtigt, damit sie ihren Status erneuern könen.
  922.  
  923. `QuitToolManager()'
  924.      Diese Funktion teilt dem ToolManager-Handler mit, daß er so bald
  925.      wie möglich stoppen sollte.
  926.  
  927.    Die komplette Library Schnittstellenbeschreibung ist im
  928. AutoDoc-Format vorhanden (siehe Docs).
  929.  
  930.  
  931. Wie man einen Tastenbefehl definiert
  932. *************************************
  933.  
  934.    Diese Kapitel beschreibt wie man einen Tastenbefehl als einen Input
  935. Description String definiert, der dann von Commodities ausgewertet
  936. werden kann. Jedes Mal, wenn ein Tastenbefehl ausgeführt wird, erzeugt
  937. Commodities eine Ereignis, das dann von ToolManager dazu benutzt wird
  938. Programmobjekte zu aktivieren oder Dock-Objekte umzuschalten. Ein
  939. Description String hat die folgende Syntax:
  940.  
  941.      [<Klasse>] {[-][<Qualifier>]} [-][upstroke] [<Tastenkode>]
  942.  
  943.    Alle Befehlsworte können groß oder klein geschrieben werden.
  944.  
  945.    `Klasse' beschreibt die InputEvent-Klasse. Dieser Parameter ist
  946. optional und falls er weggelassen wird, dann wird die Vorgabe `rawkey'
  947. benutzt. Siehe InputEvent-Klassen.
  948.  
  949.    Qualifier sind "Signale", die gesetzt oder nicht gesetzt sein
  950. müssen zu dem Zeitpunkt, an dem der Tastenbefehl ausgeführt wird,
  951. sonst wird kein Ereignis erzeugt. Für jeden Qualifier, der gesetzt
  952. sein soll, müssen Sie das Befehlswort angeben. Alle anderen Qualifier
  953. müssen dann nicht gesetzt sein. Falls Sie einen Qualifier ignorieren
  954. wollen, dann setzen sie ein `-' vor sein Befehlswort. Siehe Qualifier.
  955.  
  956.    Normalerweise wird ein Ereignis erzeugt, wenn eine Taste gedrückt
  957. wird. Falls das Ereignis generiert werden soll wenn die Taste
  958. losgelassen wird, dann müssen Sie das Befehlswort `upstroke' angeben.
  959. Wenn sowohl beim Drücken als auch beim Loslassen der Taste ein
  960. Ereignis erzeugt werden soll, dann müssen sie das Befehlswort
  961. `-upstroke' angeben.
  962.  
  963.    Der Tastenkode ist abhängig von der InputEvent-Klasse. Siehe
  964. Tastenkodes.
  965.  
  966.    Achtung: Wählen Sie ihre Tastenbefehle *sorgfältig*, denn
  967. Commodities hat eine hohe Priorität in der InputEvent-Handlerkette,
  968. d.h. vorgegebene Definitionen werden übergangen.
  969.  
  970.  
  971. InputEvent-Klassen
  972. ===================
  973.  
  974.    Commodities unterstützt die meisten der InputEvent-Klassen, die von
  975. dem input.device erzeugt werden. Diese Sektion beschreibt die Klassen,
  976. die nützlich für ToolManager sind.
  977.  
  978. `rawkey'
  979.      Dies ist die vorgegebene Klasse. Sie beschreibt alle Ereignisse,
  980.      die durch die Tastatur erzeugt werden können. Zum Beispiel
  981.      erzeugt `rawkey a' oder `a' jedesmal ein Ereignis, wenn die Taste
  982.      "a" gedrückt wird. Sie müssen einen Tastenkode für diese Klasse
  983.      angeben. Siehe rawkey Tastenkodes.
  984.  
  985. `rawmouse'
  986.      Diese Klasse beschreibt alle Ereignisse, die durch die Maus
  987.      erzeugt werden können. Sie müssen einen Tastenkode für diese
  988.      Klasse angeben. Siehe rawmouse Tastenkodes.
  989.  
  990. `diskinserted'
  991.      Ereignisse dieser Klasse werden generiert, wenn eine Diskette in
  992.      ein Laufwerk gelegt wird. Diese Klasse besitzt keine Tastenkodes.
  993.  
  994. `diskremoved'
  995.      Ereignisse dieser Klasse werden generiert, wenn eine Diskette aus
  996.      einem Laufwerk genommen wird. Diese Klasse besitzt keine
  997.      Tastenkodes.
  998.  
  999.  
  1000. Qualifier
  1001. ==========
  1002.  
  1003.    Einige Befehlsworte wurden erst bei Commodities V38 eingeführt.
  1004. Diese sind mit einem `*' markiert.
  1005.  
  1006. `lshift', `left_shift' *
  1007.      Linke Shift-Taste.
  1008.  
  1009. `rshift', `right_shift' *
  1010.      Rechte Shift-Taste.
  1011.  
  1012. `shift'
  1013.      Irgendeine Shift-Taste.
  1014.  
  1015. `capslock', `caps_lock' *
  1016.      Caps-Lock-Taste.
  1017.  
  1018. `caps'
  1019.      Irgendeine Shift-Taste oder die Caps-Lock-Taste.
  1020.  
  1021. `control', `ctrl' *
  1022.      Control-Taste.
  1023.  
  1024. `lalt', `left_alt' *
  1025.      Linke Alt-Taste.
  1026.  
  1027. `ralt', `right_alt' *
  1028.      Rechte Alt-Taste.
  1029.  
  1030. `alt'
  1031.      Irgendeine Alt-Taste.
  1032.  
  1033. `lcommand', `lamiga' *, `left_amiga' *, `left_command' *
  1034.      Linke Amiga-/Kommando-Taste.
  1035.  
  1036. `rcommand', `ramiga' *, `right_amiga' *, `right_command' *
  1037.      Rechte Amiga-/Kommando-Taste.
  1038.  
  1039. `numericpad', `numpad' *, `num_pad' *, `numeric_pad' *
  1040.      Dieses Befehlswort *muß* angegeben werden, wenn eine Taste von der
  1041.      Zehnertastatur benutzt wird.
  1042.  
  1043. `leftbutton', `lbutton' *, `left_button' *
  1044.      Linke Maustaste. Siehe unten.
  1045.  
  1046. `midbutton', `mbutton' *, `middlebutton' *, `middle_button' *
  1047.      Mittlere Maustaste. Siehe unten.
  1048.  
  1049. `rbutton', `rightbutton' *, `right_button' *
  1050.      Rechte Maustaste. Siehe unten.
  1051.  
  1052. `repeat'
  1053.      Dieser Qualifier ist gesetzt, wenn die Tastenwiederholung aktiv
  1054.      ist. Dies ist nur sinnvoll für die InputEvent-Klasse `rawkey'.
  1055.  
  1056.    Achtung: Commodities V37 hat einen Fehler, der die Benutzung von
  1057. `leftbutton', `midbutton' und `rbutton' als Qualifier verhindert.
  1058. Dieser Fehler wurde in V38 behoben.
  1059.  
  1060.  
  1061. Tastenkodes
  1062. ============
  1063.  
  1064.    Jede InputEvent-Klasse besitzt ihre eigenen Tastenkodes:
  1065.  
  1066.  
  1067. Tastenkodes für die InputEvent-Klasse `rawkey'
  1068. -----------------------------------------------
  1069.  
  1070.    Einige Befehlsworte wurden erst bei Commodities V38 eingeführt.
  1071. Diese sind mit einem `*' markiert.
  1072.  
  1073. `a'-`z', `0'-`9', ...
  1074.      ASCII-Zeichen.
  1075.  
  1076. `f1', `f2', ..., `f10', `f11' *, `f12' *
  1077.      Funktionstasten.
  1078.  
  1079. `up', `cursor_up' *, `down', `cursor_down' *
  1080. `left', `cursor_left' *, `right', `cursor_right' *
  1081.      Cursor-Tasten.
  1082.  
  1083. `esc', `escape' *, `backspace', `del', `help'
  1084. `tab', `comma', `return', `space', `spacebar' *
  1085.      Spezial-Tasten.
  1086.  
  1087. `enter', `insert' *, `delete' *
  1088. `page_up' *, `page_down' *, `home' *, `end' *
  1089.      Tasten der Zehnertastatur. Jeder dieser Tastenkodes *muß* mit dem
  1090.      Qualifier `numericpad' benutzt werden!
  1091.  
  1092.  
  1093. Tastenkodes für die InputEvent-Klasse `rawmouse'
  1094. -------------------------------------------------
  1095.  
  1096.    Diese Befehlsworte wurden erst bei Commodities V38 eingeführt. Sie
  1097. sind nicht verfügbar in V37.
  1098.  
  1099. `mouse_leftpress'
  1100.      Drücke die linke Maustaste.
  1101.  
  1102. `mouse_middlepress'
  1103.      Drücke die mittlere Maustaste.
  1104.  
  1105. `mouse_rightpress'
  1106.      Drücke die rechte Maustaste.
  1107.  
  1108.    Achtung: Um einen dieser Tastenkodes zu benutzen, müssen sie auch
  1109. das entsprechende Qualifier-Befehlswort angeben, z.B.
  1110.  
  1111.      rawmouse leftbutton mouse_leftpress
  1112.  
  1113.  
  1114. Beispiele für Tastenbefehle
  1115. ============================
  1116.  
  1117. `ralt t'
  1118.      Rechte Alt-Taste festhalten und "t" drücken.
  1119.  
  1120. `ralt lalt t'
  1121.      Rechte *und* linke Alt-Taste festhalten und "t" drücken.
  1122.  
  1123. `alt t'
  1124.      Irgendeine Alt-Taste festhalten und "t" drücken.
  1125.  
  1126. `rcommand f2'
  1127.      Rechte Amiga-Taste festhalten und die zweite Funktionstaste
  1128.      drücken.
  1129.  
  1130. `numericpad enter'
  1131.      Enter-Taste auf der Zehnertastatur drücken.
  1132.  
  1133. `rawmouse midbutton leftbutton mouse_leftpress'
  1134.      Mittlere Maustaste festhalten und die linke Maustaste drücken.
  1135.  
  1136. `diskinserted'
  1137.      Eine Diskette in ein Laufwerk einlegen.
  1138.  
  1139.  
  1140. Die Entwicklung von ToolManager
  1141. ********************************
  1142.  
  1143. 2.0, Datum 26.09.1992
  1144.         - Komplett neues Konzept (objektorientiert)
  1145.  
  1146.         - (Fast) komplette Neuprogrammierung
  1147.  
  1148.         - ToolManager ist nun in zwei Teile aufgespalten
  1149.  
  1150.         - Der Handler ist in eine shared Library eingebettet
  1151.  
  1152.         - Die Konfiguration wird nun mit einem Voreinsteller bearbeitet
  1153.  
  1154.         - Das Konfigurationsdateiformat wurde wieder geändert :-) Es
  1155.           ist nun eine IFF Datei und liegt in ENV:
  1156.  
  1157.         - Mehrere Docks und Docks mit mehrere Spalten sind nun möglich
  1158.  
  1159.         - Es gibt Docks mit neuem Aussehen
  1160.  
  1161.         - Docks richten sich nun automatisch nach der Größe des
  1162.           größten Bildes
  1163.  
  1164.         - Sound Unterstützung
  1165.  
  1166.         - ARexx werden direkt in Programmobjekten unterstützt
  1167.  
  1168.         - ToolManager kann nun ohne Workbench benutzt werden. Wenn die
  1169.           Workbench nicht läuft, dann benutzt er keine App* Merkmale
  1170.           mehr.
  1171.  
  1172.         - Locale Unterstützung
  1173.  
  1174.         - Der Befehlspfad der Workbench wird für CLI Programme benutzt
  1175.  
  1176.         - Ein eigener Prozess startet die WB Programme
  1177.  
  1178. 1.0 bis 1.5
  1179.      Die Bemerkungen zu diesen Versionen entnehmen Sie bitte der
  1180.      englischen Dokumentation.
  1181.  
  1182.  
  1183. Der Autor möchte danken...
  1184. ***************************
  1185.  
  1186.    ToolManager hat mehrere große Entwicklungsphasen seit seiner ersten
  1187. Programmierung Mitte 1990 durchlebt. Diese Entwicklung wäre unmöglich
  1188. gewesen, wenn ich nicht den enormen Feedback von einigen ToolManager
  1189. Benutzern gehabt hätte. Viele Ideen & Merkmale stammen aus dieser
  1190. Quelle...
  1191.  
  1192.    Daher möchte ich den folgenden Personen danken:
  1193.  
  1194. Für die Alpha-/Beta-Tests, Ideen & Bug Reports:
  1195.      Die Amigagruppe unseres Computerclubs (Computerclub an der RWTH
  1196.      Aachen), Olaf 'Olsen' Barthel, Georg Hessmann (Gucky), Markus
  1197.      Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias
  1198.      Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda),
  1199.      Juergen Weinelt, Brian Wright (SteveVai), Petra Zeidler
  1200.      (stargazer) und viele andere...
  1201.  
  1202. Matthew Dillon
  1203.      Ohne dein *exzellentes* C Entwicklungssystem DICE und verschiedener
  1204.      anderer Hilfsprogramme würde es keinen ToolManager geben!
  1205.  
  1206. Für ihre hervorragenden Grafiken:
  1207.      Andreas Harrenberg, Georg Hessmann, Michael "Mick" Hohmann, Markus
  1208.      Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan
  1209.      Peter, Matthias Scheler, Brian Wright
  1210.  
  1211. Für die Übersetzungen:
  1212.      Tomi Blinnikka (Finnisch), Dr. Peter Kittel (Deutsch), Klaus
  1213.      Melchior (Eifel Platt), Rickard Olsson (Schwedisch), Marc Schaefer
  1214.      (Französisch & Italienisch)
  1215.  
  1216. Alle Leute in West Chester:
  1217.      Für die Entwicklung des Amigas und seines hervorragenden
  1218.      Betriebssystems.
  1219.  
  1220. Alle Benutzer, die mir Geld geschickt haben:
  1221.      Ich habe in den 1.X Versionen nicht danach gefragt, aber es ist
  1222.      erfreulich, wenn jemand meine Arbeit so sehr schätzt.
  1223.  
  1224. Alle Benutzer, die mir einen Brief geschickt haben:
  1225.      Ich habe es genossen, Eure Briefe zu lesen!
  1226.  
  1227. und natürlich alle, die ich vergessen habe zu erwähnen...
  1228.  
  1229. Index
  1230. ******
  1231.  
  1232.  
  1233.  
  1234.  Übersetzer                            Source
  1235.  Übersetzungen                         Locale
  1236.  TeX                                    Docs
  1237.  ARexx-Skripte                          Scripts
  1238.  ASCII Dokumentation                    Docs
  1239.  Adresse                                Adresse des Autors
  1240.  AmigaGuide                             Docs
  1241.  Beispielbilder                         Graphics
  1242.  Beispiele für Tastenbefehle           Beispiele für Tastenbefehle
  1243.  Bildobjekte                            Bild
  1244.  Bug reports                            Adresse des Autors
  1245.  Catalog-Dateien                        Locale
  1246.  Compilerunterstützung                 Programmers
  1247.  Copyright                              Copyright
  1248.  Danksagungen                           Danksagungen
  1249.  DeleteTool                             Goodies
  1250.  Diskinserted                           InputEvent-Klassen
  1251.  Diskremoved                            InputEvent-Klassen
  1252.  Distribution                           Copyright
  1253.  Distributionsdateien                   Distributionsdateien
  1254.  Dock-Objekte                           Dock
  1255.  Docs Verzeichnis                       Docs
  1256.  Dokumentation                          Docs
  1257.  E-Mail                                 Adresse des Autors
  1258.  Einführung zu den ToolManager-ObjektenKonzepte
  1259.  Einführung zum ToolManager            Einführung
  1260.  Gedruckte Dokumentation                Docs
  1261.  Genehmigungen                          Copyright
  1262.  Geschichte                             Geschichte
  1263.  GetPubName                             Goodies
  1264.  GiftWare                               Wichtig
  1265.  Goodies Verzeichnis                    Goodies
  1266.  Graphics Verzeichnis                   Graphics
  1267.  InputEvent-Klassen                     InputEvent-Klassen
  1268.  Installation (schnell)                 Schnellinstallation
  1269.  InterNet Adresse                       Adresse des Autors
  1270.  Kommentare                             Adresse des Autors
  1271.  Konfiguration                          Voreinstellungen
  1272.  Konzepte                               Konzepte
  1273.  L Verzeichnis                          L
  1274.  Library Dokumentation                  Docs
  1275.  Library Schnittstelle                  Library
  1276.  Libs Verzeichnis                       Libs
  1277.  List: Qualifier                        Qualifier
  1278.  Liste: rawkey Tastenkodes              rawkey Tastenkodes
  1279.  Liste: rawmouse Tastenkodes            rawmouse Tastenkodes
  1280.  Locale Verzeichnis                     Locale
  1281.  Lokalisation                           Locale
  1282.  Menüobjekte                           Menü
  1283.  Objekte                                Objekte
  1284.  Piktogrammobjekte                      Piktogramm
  1285.  Postadresse                            Adresse des Autors
  1286.  Prefs Verzeichnis                      Prefs
  1287.  Programmers Verzeichnis                Programmers
  1288.  Programmkonzepte                       Konzepte
  1289.  Programmobjekte                        Programm
  1290.  Programmversionen                      Geschichte
  1291.  Qualifier                              Qualifier
  1292.  Quelltext                              Source
  1293.  Rawkey                                 InputEvent-Klassen
  1294.  Rawmouse                               InputEvent-Klassen
  1295.  Rechtliche Dinge                       Copyright
  1296.  Referenz: Distributionsdateien         Distributionsdateien
  1297.  Referenz: Library Schnittstelle        Library
  1298.  Referenz: Tastenbefehle                Tastenbefehle
  1299.  Referenz: ToolManager-Objekte          Objekte
  1300.  Referenz: Voreinsteller                Voreinstellungen
  1301.  Schnellinstallation                    Schnellinstallation
  1302.  Scripts Verzeichnis                    Scripts
  1303.  Shell-Skripte                          Scripts
  1304.  Source Verzeichnis                     Source
  1305.  Spenden                                Adresse des Autors
  1306.  Sprachdateien                          Locale
  1307.  Sprachen                               Locale
  1308.  Tastenbefehle                          Tastenbefehle
  1309.  Tastenkodes für rawkey                rawkey Tastenkodes
  1310.  Tastenkodes für rawmouse              rawmouse Tastenkodes
  1311.  Texinfo                                Docs
  1312.  Tonobjekte                             Ton
  1313.  ToolManager-Objekte                    Objekte
  1314.  UPD                                    Goodies
  1315.  V38 Merkmale                           Wichtig
  1316.  Verbote                                Copyright
  1317.  Versionen                              Geschichte
  1318.  Voreinsteller                          Voreinstellungen
  1319.  WBStart 1.2                            L
  1320.  WBStart-Handler                        L
  1321.  WBStartup Verzeichnis                  WBStartup
  1322.  Wichtige Bemerkungen                   Wichtig
  1323.  
  1324.